home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / DiskUtil / Misc / BTNTape / doc / messages.doc < prev    next >
Text File  |  1994-04-03  |  7KB  |  151 lines
  1.  
  2. Here are the messages printed via TapeMon by the BTN handler version 3.0,
  3. in no particular order, with reasons for each message.
  4.  
  5. *** Sense: %s, other= %02X,%02X
  6.        Printed when the tape drive returns a SCSI "check condition"
  7.        in response to a SCSI command that BTN has sent to the drive.
  8.        Sometimes this may indicate an error or problem, but not always.
  9.        The reason for the condition is encoded into a "sense key"
  10.        which is spelled out for you in this message.  The SCSI spec
  11.        defines these keys:
  12.           NO SENSE - nothing unusual to report
  13.           RECOVERED ERROR - something went wrong, but the drive fixed it up
  14.           NOT READY - human intervention is required (insert tape)
  15.           MEDIUM ERROR - an unrecoverable flaw in the tape material
  16.           HARDWARE ERROR - the drive is broken (still have your receipt?)
  17.           ILLEGAL REQUEST - the SCSI command/function is not supported by
  18.             this drive, or there are bits in the command that the drive
  19.             doesn't like, or the drive is being asked to do something
  20.             it doesn't feel like doing right now.
  21.           UNIT ATTENTION - a transient condition generated whenever a
  22.             new tape is inserted.
  23.           DATA PROTECT - the tape medium is write protected
  24.           BLANK CHECK - the drive has attempted to read past the blank spot,
  25.             the end of the last-written file, or an erased tape.
  26.           FILEMARK - the drive has attempted to read a filemark, which
  27.             indicates the end of the file has been reached.
  28.           END-OF-MEDIUM - the drive has reached physical end of the tape
  29.           VOLUME OVERFLOW - some drives indicate this at end of tape
  30.           INCORRECT LENGTH - BTN asked to read a block smaller than
  31.             what was written on the tape.  BS is probably incorrect.
  32.  
  33.        The "other" bytes printed are bytes 12 and 13 of the sense data.
  34.        For some drives, such as the MCD-40 and SCSI-2 drives, this is
  35.        a subcode indicating more information about the sense key.
  36.  
  37. *** SCSI %s ERROR
  38.        The scsi-direct driver/adapter returned an error in response to BTN's
  39.        attempt to send a SCSI command to the drive.  These errors are
  40.        defined by Commodore:
  41.           SELF-UNIT - the UN number is the same as that of the SCSI adapter
  42.           DMA - I don't know what this means.  Maybe an adapter problem.
  43.           PHASE - the drive and the SCSI adapter are not in-sync with
  44.              their SCSI phases.  There may be a mismatch in data transfer
  45.              caused by incorrect block size (BS value), or the SCSI bus
  46.              may be improperly terminated.
  47.           PARITY - a parity error on the SCSI bus
  48.           SELECT-TIMEOUT - the adapter timed out waiting for a response
  49.              from the drive.
  50.  
  51. *** Can't get %u bytes for tape buffers
  52.        There is insufficient memory to allocate two buffers of NB*BS
  53.        bytes (or maybe the memory is too fragmented).  Use a smaller
  54.        value for NB, or free up some memory, or reboot.
  55.  
  56. *** Invalid open name/combo %s
  57.        * The name used to access the tape file is unrecognized.
  58.           The name must be one of the following:  TAPE:  TAPE:R  TAPE:END
  59.             TAPE:APP  TAPE:NR  TAPE:*  TAPE:number  TAPE:RAWCMD  TAPE:MODESEL
  60.        * The function is incompatible with the open mode or drive model.
  61.           Examples: you cannot read from TAPE:APP, and TAPE:APP is always
  62.           invalid for direct access drives.
  63.  
  64. *** Current block size = %u
  65. *** Mode Select, new block size %d
  66.        Informative messages printed when the BS value is different than
  67.        the block size of the drive.  BTN will attempt to command the
  68.        drive to switch to the new size.
  69.  
  70. *** Capacity: %u blocks
  71.        Informative message printed only for direct access drives describing
  72.        the number of blocks available on this particular cartridge.
  73.  
  74. *** %s Opened file %d / at block %d
  75.        Informative message printed when Open() is successful.
  76.  
  77. *** Closed at block %u, next file= %d
  78.        Informative message printed when Close() is finished.
  79.        The block number is the next available block.  The tape head
  80.        is positioned ready to access this block for the next operation.
  81.        The number of the file or block that will be written next is shown.
  82.  
  83. *** Function/mode error
  84.        The application is attempting to mix Read()s and Write()s.
  85.        It can't read while opened for writes, and vice versa.
  86.  
  87. *** %s is read-only
  88.        The application is attempting to write to the device when
  89.        the handler is operating in read only mode (RO-1).
  90.  
  91. *** %s is append-only
  92.        The application is attempting to write over an existing file
  93.        when the handler is operating in append-only mode (AO-1).
  94.  
  95. *** Disallowed seek type=%d off=%d curr=%d
  96.        A Seek() request was rejected because the type of seek is not
  97.        supported or it cannot be done at this point.
  98.  
  99. *** Error during read
  100. *** Error during write
  101.        Indicates that a medium error was encountered during a read or write.
  102.  
  103. *** Unsupported_Pkt=%d
  104.        Informative message indicating that an AmigaDOS packet was
  105.        rejected as "unknown", because the requested function does
  106.        not apply to BTN.  Not usually a problem.
  107.  
  108. *** Skipping to end of data
  109. *** (doing it the hard way)
  110.        Informative message printed when Open()ing TAPE:APP.  If the
  111.        drive doesn't directly support this function, the "hard way"
  112.        message is printed, and BTN begins skipping individual files.
  113.  
  114. *** Skipping to file %d
  115.        Informative message printed when reading from TAPE:number
  116.        on a sequential drive.
  117.  
  118. *** Unable to position tape
  119.        Printed when some kind of error occurs when BTN tries to get
  120.        the tape into the necessary position for Open().  You will
  121.        get a "replace volume" requester.
  122.  
  123. *** Time to insert tape# %d
  124.        Informative message printed at end of tape.  Also a requester.
  125.  
  126. *** Writing block %u x %d
  127. *** Reading block %u x %d
  128.        Informative messages printed just before a SCSI read or write
  129.        command is sent to the drive.  The block number is relative
  130.        to the beginning of the file for sequential drives, and is
  131.        the actual block number for direct access drives.  The length
  132.        is the number of bytes (NB*BS).
  133.  
  134. *** Rewinding
  135.        You guess this one...
  136.  
  137. *** Writing filemark
  138.        Informative message printed when Close()ing a file being written.
  139.  
  140. *** Retensioning
  141.        Informative message printed when Unit Attention status occurs and
  142.        RT-1 was specified in the mountlist.  The retensioning operation
  143.        may take several minutes to complete.
  144.  
  145. *** Raw command %02X
  146.        Informative message printed when writing to TAPE:RAWCMD.
  147.  
  148. *** User Mode-Select
  149.        Informative message printed when writing to TAPE:MODESEL.
  150.  
  151.